From ee5948820e3ab3f2b8ccf435ac491b2f4e7b4fd7 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Fri, 29 Jun 2007 19:58:25 +0000
Subject: [PATCH] Additions

svn path=/trunk/; revision=18295
---
 docs/reference/ChangeLog                  |  4 ++++
 docs/reference/gtk/tmpl/gtkbuildable.sgml | 26 +++++++++++++++--------
 2 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 235e127455..551104b22d 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,7 @@
+2007-06-29  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkbuildable.sgml: Some additions
+
 Wed Jun 27 11:57:13 2007  Tim Janik  <timj@imendio.com>
 
 	* gtk/tmpl/gtkmenu.sgml: fixed push_in description.
diff --git a/docs/reference/gtk/tmpl/gtkbuildable.sgml b/docs/reference/gtk/tmpl/gtkbuildable.sgml
index 47000e289d..0778d003b1 100644
--- a/docs/reference/gtk/tmpl/gtkbuildable.sgml
+++ b/docs/reference/gtk/tmpl/gtkbuildable.sgml
@@ -2,17 +2,17 @@
 GtkBuildable
 
 <!-- ##### SECTION Short_Description ##### -->
-SHORT
+Interface for objects that can be built by GtkBuilder
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-LONG
+In order to allow construction from a XML UI description,
+an object class must implement the #GtkBuildable interface.
+The interface includes method for setting names and properties
+of objects, parsing custom tags, constructing child objects.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
-<para>
-SEE ALSO
-</para>
 
 <!-- ##### SECTION Stability_Level ##### -->
 
@@ -25,12 +25,20 @@ SEE ALSO
 
 <!-- ##### STRUCT GtkBuildableIface ##### -->
 <para>
-
+The #GtkBuildableIface interface contains method that are
+necessary to allow #GtkBuilder to construct an object from
+a XML UI description.
 </para>
 
-@g_iface: 
-@set_name: 
-@get_name: 
+@g_iface: the parent class
+@set_name: Stores the name attribute given in the XML UI description.
+  #GtkWidget maps this to the GtkWidget:name property, and 
+  gtk_buildable_set_name() has a fallback implementation that stores
+  the name as object data. Implement this method if your object
+  has some notion of "name" and it makes sense to map the XML name
+  attribute to it.
+@get_name: The getter corresponding to @set_name. Implement this
+  if you implement @set_name.
 @add_child: 
 @set_buildable_property: 
 @construct_child: 
-- 
2.30.2